<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
     sgecommdcntl - Grid Engine communication agent control  com-
     mand

SYNOPSIS
     sgecommdcntl [ -d | -k | -t level ] [ -gid commprocname ]  [
     -h[elp] ] [ -p port ] [ -S ] [ -unreg commprocname id ]

DESCRIPTION
     <I>sgecommdcntl</I>  can  be  used  to  control  the  behavior   of
     <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>  or  to  retrieve  information  from  a running
     <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>.

OPTIONS
     -d   Dump internal structures of  the  running  <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>
          process   to   /<I>tmp</I>/<I>commd</I>/<I>commd</I>.<I>dump</I>.   The   directory
          /<I>tmp</I>/<I>commd</I> must exist and <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> must have  write
          access to it. The request is ignored otherwise.
          This option is mainly intended for debugging  purposes.
          The  functionality of the addressed <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> is not
          affected.

     -k   Kill the addressed  <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>.   Pending  communica-
          tions  at  the time of a kill request will be discarded
          immediately, yet the shutdown of  a  <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>  will
          not leave the processes being connected to the aborting
          process in an inconsistent state.

     -t level
          <I>sgecommdcntl</I> establishes a connection  to  <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>
          and  displays continuous trace output corresponding the
          trace level specified by level. The output consists  of
          a  subset of the trace output displayed if <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>
          is invoked with the -ll option.
          Currently the only trace level being supported is 255.

     -gid commprocname
          Retrieve communication process identification number of
          commprocname.   Grid  Engine components which enroll to
          <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> to be able to communicate with other  Grid
          Engine processes are registered by <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> with an
          unique identification consisting of a name and an iden-
          tification number. The identification name is identical
          with the  name  of  the  Grid  Engine  component  (e.g.
          sge_qmaster  for  <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>).   The identification
          number can be retrieved by the -gid option.

     -help
          Prints  a listing of all options.

     -p commdport
          Port  number  to  be   used   in   order   to   address
          <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>.

     -S   Forces  secure  ports  to  be  used  for  communication
          between  <I>sge</I>_<I>commd</I>s  and between other Grid Engine com-
          ponents and the  <I>sge</I>_<I>commd</I>s.  This  requires  all  Grid
          Engine  daemons  to be started with root permission and
          the client programs to be configured set-uid  root.  In
          turn,  it  ensures  that  unauthorized communication is
          prohibited for non-root accounts.

     -unreg commprocname id
          Unregister   Grid   Engine    component    commprocname
          registered  with  Id  id  to <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> (see the -gid
          above for a description of commprocname and id).
          To unregister a Grid Engine component from <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>
          can  become  necessary  if a Grid Engine daemon such as
          <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>,  <B><A HREF="../htmlman8/sge_execd.html">sge_execd(8)</A></B>   or   <B><A HREF="../htmlman8/sge_schedd.html">sge_schedd(8)</A></B>   is
          aborted in an uncontrolled fashion (e.g. by sending the
          signal SIGKILL via  <B><A HREF="../htmlman1/kill.html">kill(1)</A></B>)  and  <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>  denies
          restart of that component with the message error enrol-
          ling to commd: COMMPROC ALREADY REGISTERED.
          The registration facility of <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>  is  used  to
          avoid redundant Grid Engine daemons running on the same
          host. If a Grid Engine component is aborted but  unable
          to  unregister  from  <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>  the registration is
          kept alive until a time-out of several  minutes  passes
          or  until  the  communication  process  is unregistered
          manually.

ENVIRONMENTAL VARIABLES
     COMMD_PORT     If set,  specifies  the  tcp  port  on  which
                    <I>sgecommdcntl</I>  is  expected to listen for com-
                    munication requests.  Most installations will
                    use  a  services  map entry instead to define
                    that port.

     COMMD_HOST     If set, specifies the host on which the  par-
                    ticular  <I>sge</I>_<I>commd</I> to be used for Grid Engine
                    communication of  <I>sgecommdcntl</I>  resides.  Per
                    default the local host is used.

SEE ALSO
     <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>,  <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>,  <B><A HREF="../htmlman8/sge_execd.html">sge_execd(8)</A></B>,  <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>,
     <B><A HREF="../htmlman8/sge_schedd.html">sge_schedd(8)</A></B>.

COPYRIGHT
     See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and  permis-
     sions.




</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
